home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / utils / sftm140.arj / SFTM.DOC < prev    next >
Text File  |  1993-05-30  |  8KB  |  212 lines
  1.  
  2. SFTM 1.4
  3. --------
  4. Copyright (c) 1992-1993 by Craig R. Clark
  5.  
  6.  
  7. DESCRIPTION
  8.  
  9. System File Table Monitor is a full screen, interactive monitor written
  10. in Turbo Pascal 6.0 that displays a list of filenames currently open,
  11. along with a summary of the access mode used to open the file, and the
  12. current sharing mode.
  13.  
  14. Displayed on the upper status bar are the number of file tables found in
  15. DOS, the total number of handles allocated via FILES= statements, the
  16. maximum number of handles used at one time, and the number of files
  17. currently open.
  18.  
  19. A clock is displayed on the lower status bar, as well as the program
  20. title and version number.  If run on a machine with the Lantastic REDIR
  21. loaded, the machine name also appears on this status bar.
  22.  
  23.  
  24. COMPATIBILITY
  25.  
  26. SFTM has been tested under Desqview 2.42, Windows 3.1, Lantastic 5.0,
  27. and DOS 6.0 on 286, 386 and 486 processors.  It displays the additional
  28. file tables created by Quarterdeck's FILES.COM utility included with
  29. QEMM.
  30.  
  31. It can be run in a 64K Desqview window, yet still monitor all files
  32. opened by every other application running under Desqview.  Functionality
  33. under Windows 3.1 is similar.
  34.  
  35.  
  36. OPERATION
  37.  
  38. To run SFTM.EXE, type 'SFTM' at the DOS prompt or create a suitable DV
  39. or Windows PIF for it.  It will detect the current video mode, and
  40. adjust for monochrome or colour adapters.  It will also determine the
  41. maximum number of displayable lines, and run in that mode, whether it is
  42. 25, 28, 43, 50 lines or higher.
  43.  
  44. There are three optional command line parameters, in addition to the
  45. ubiquitous '/?'.  They are:
  46.                                                                                 
  47.   /D delay    time (ms) between successive scans of the system                  
  48.               file table; default is 10, range is 0 to 1000
  49.                                                                                 
  50.   /P path     drive and directory for SFTM.DAT,                                 
  51.               default is current drive and directory                            
  52.                                                                                 
  53.   /S          suppress creation and update of SFTM.DAT                          
  54.                                                                                 
  55. None of the parameters are mandatory; by default SFTM will delay 10
  56. milliseconds between successive scans of the file table, and will create
  57. a data file in the current directory.  See the enclosed SFT.BAT for a
  58. typical usage.
  59.  
  60. The delay parameter was introduced to avoid slowing down a heavily
  61. loaded machine.  It is particularly useful on a Lantastic server that
  62. has multiple printers attached.  With the default setting of 10, some
  63. slowdown of despooling may be noticed.  Setting the delay to a higher
  64. number will avoid any slowdown.
  65.  
  66. With a large delay factor, some files may be missed if they are briefly
  67. opened and closed again.  With a delay factor of '0' (zero), some
  68. slowdown may be noticed if running SFTM under Desqview or Windows.
  69.  
  70. The path parameter was added at the request of a registered user.  The
  71. default path for the SFTM.DAT file is the current directory.  This data
  72. file contains a number corresponding to the maximum file handles in use
  73. at one time.  Previously the maximum would be lost when exiting SFTM;
  74. now it is recorded to a file.
  75.  
  76. If you don't want the data file in your current directory, just include
  77. a complete path (drive/directory) to where you would like it.  SFTM will
  78. ensure the path exists first, and then check it for the existence of a
  79. previous data file.  If one exists, the 'MAXIMUM USED' total on the
  80. screen is updated to that number.  Upon exit, the new total is written
  81. back to this file.
  82.  
  83. The 'suppress' parameter makes SFTM ignore the data file entirely.  No
  84. file will be looked for, and no file will be created.  This is how the
  85. earlier versions of SFTM worked.  If you use this parameter, SFTM will
  86. always start your cumulative totals from zero, and the totals will be
  87. lost when exiting SFTM.
  88.  
  89. When using a normal 25 line screen, up to 88 files can be simultaneously
  90. displayed, along with their access modes.  On a 50 line screen, up to
  91. 188 files can be simultaneously displayed.
  92.  
  93. This utility can be invaluable in determining the access modes used by
  94. other software as an aid in troubleshooting system problems or for
  95. program debugging.  It will also be obvious if FILE HANDLES are set
  96. dangerously low, or excessively high.
  97.  
  98. Run on a Lantastic server, it is a useful alternative to ALONE.  All
  99. files open through DOS can be seen at a glance, and if left running for
  100. an extended period, the statistic collected on maximum files opened is
  101. useful in determining the optimum number of file handles to allocate
  102. without wasting resources.
  103.  
  104. The abbreviations used are as follows:
  105.  
  106. Access Modes:
  107.  
  108. RO - Read Only
  109. RW - Read/Write
  110. WO - Write Only
  111.  
  112. Sharing Modes:
  113.  
  114. CMP - Compatibility Mode
  115. EXC - Exclusive or Deny Read/Write
  116. DWR - Deny Write
  117. DRD - Deny Read
  118. DNO - Deny None
  119.  
  120.  
  121. COPYRIGHT
  122.  
  123. This is shareware software, not free software.  You are allowed to use
  124. it without obligation for a 10-day evaluation period.  For use beyond
  125. that time please register this software.
  126.  
  127. Registration will allow me to continue development of this utility. This
  128. software is not crippled in any way, as I do not believe you can fully
  129. evaluate the usefulness of crippled software.
  130.  
  131. Permission is given to shareware and CD-ROM compilers, online services
  132. and Bulletin Board operators to distribute or carry this archive.  The
  133. files SFTM.EXE and SFTM.DOC must not be altered in any way.
  134.  
  135.  
  136. FUTURE DEVELOPMENT
  137.  
  138. A TSR version.
  139. Remote monitoring.
  140. Enhancements to allow for the display of more files than can fit on the
  141. screen at one time (multiple pages of files).
  142. Optional display of the complete drive/path.
  143. Name(s) of owner program(s).
  144. Suggestions?
  145.  
  146.  
  147. SUPPORT
  148.  
  149. Bug reports are welcome, and verified bugs will be corrected in the next
  150. release.
  151.  
  152. Support BBS:
  153. Christian Deliverance BBS - two lines, 24 hours a day
  154. 1-809-292-7376 USR HST 14.4K   1-809-292-1774 Intel V.32bis
  155.  
  156. Network Addresses:
  157. Fidonet 1:18/20 (no crash mail)
  158.  
  159. I am also a regular caller to the Artifacts BBS, 1-602-293-0068.  I am
  160. not affiliated with Artisoft in any way, and Artisoft is in no way
  161. responsible for support of this product.  I give their number for use
  162. only if you cannot reach me any other way.  The most timely support will
  163. always be through my support BBS numbers listed above.
  164.  
  165.  
  166. DISCLAIMER
  167.  
  168. While I have made every effort to ensure that this software works as it
  169. is intended to and I have tested it under a variety of operating
  170. conditions, I cannot be held responsible in the unlikely event of damage
  171. to your system by this product.
  172.  
  173.  
  174. REGISTRATION
  175.  
  176. Cost $15 US, $19 Canadian funds.
  177.  
  178. If you would like the latest version mailed to you on a diskette, please
  179. enclose an additional $5 US ($7 Canadian), specifying size and density.
  180.  
  181. All remittance should be in US or Canadian funds - personal cheques and
  182. money orders are acceptable.  Please make payable to 'Craig R. Clark'.
  183.  
  184. All funds and any other correspondence should be mailed to:
  185.  
  186. Craig R. Clark
  187. P.O. Box DV 3
  188. Devonshire, DV BX
  189. BERMUDA.
  190.  
  191.  
  192. REVISION HISTORY
  193. ----------------
  194.  
  195. May 30th, 1993 - Version 1.4
  196. General release version; e-mail address changed.
  197.  
  198. May 8th, 1993 - Version 1.39
  199. New features; added command line switches.  Cumulative total for maximum
  200. handles used written to file.  User settable delay factor for
  201. performance issues.  Docs updated.
  202.  
  203. March 21st, 1993 - Version 1.32
  204. Minor bug fix.  Swapped positions of top status line and bottom status
  205. bar.  Changed wording of top status line.  Cosmetic changes.
  206.  
  207. January 27th, 1993 - Version 1.30
  208. Initial public release after extensive beta testing.
  209.  
  210. ** End.
  211.  
  212.